환경설정 옵션
다음 표는 Jekyll 에서 사용할 수 있는 환경설정과 그에 해당하는 옵션 (설정 파일에 사용) 과 플래그 (명령어에 사용) 의 목록입니다.
전역 환경설정
| 설정 | 옵션과 플래그 |
|---|---|
| Site Source Jekyll 이 읽어들일 파일의 경로를 변경한다. | source: DIR -s, --source DIR |
| Site Destination Jekyll 이 생성할 파일의 경로를 변경한다. | destination: DIR -d, --destination DIR |
| Safe 사용자 플러그인을 비활성화하고 디스크에 캐쉬하며, 심볼릭 링크를 무시한다. | safe: BOOL --safe |
| Disable Disk Cache 4.1.0 Disable caching of content to disk in order to skip creating a .jekyll-cache or similar directory at the source to avoid interference with virtual environments and third-party directory watchers. Caching to disk is always disabled in safe mode. | disable_disk_cache: BOOL --disable-disk-cache |
| Exclude 특정 디렉토리나 파일을 변환되지 않도록 제외시킨다. Site Source 를 기준으로 한 상대경로로 정의하며, Site Source 디렉토리 바깥의 다른 경로는 지정할 수 없다. | exclude: [DIR, FILE, ...] |
| Include 특정 디렉토리나 파일을 변환 작업에 강제로 포함시킨다. 대표적인 예로는 .htaccess 가 있는데, 점으로 시작하는 파일은 제외하는 것이 디폴트 방식이기 때문이다. | include: [DIR, FILE, ...] |
| Keep files 사이트 생성 전 Site Destination 을 초기화 때, 그대로 보관할 파일을 지정한다. Jekyll 이 아닌 다른 빌드 시스템에서 생성하는 파일이나 데이터에 유용하게 쓰이는 옵션이다. destination 기준의 상대경로로 입력한다. | keep_files: [DIR, FILE, ...] |
| Time Zone 사이트 생성에 사용할 타임존을 지정한다. 이 옵션은 루비가 날짜와 시간을 생성/수정할 때 사용하는 환경변수인 TZ 를 설정한다. IANA 타임존 데이터베이스의 모든 항목을 사용할 수 있다 (예, America/New_York). 사용할 수 있는 모든 설정값들의 목록은 여기에서 찾을 수 있다. 로컬 장비에서 서비스 될 때, 타임존의 기본값은 자신의 OS 에 의해 설정된다. 하지만 원격 호스트/서버에서 서비스될 때, 타임존 기본값은 서버 환경설정이나 장소에 따라 다르다. | timezone: TIMEZONE |
| Encoding 파일의 인코딩을 지정한다. 루비 1.9 또는 이후 버전에서만 사용 가능하다). 디폴트값은 2.0.0 버전부터 utf-8 이고, 2.0.0 이전 버전에서는 루비 디폴트값인 ASCII-8BIT 를 사용하는 nil 이었다. 사용할 수 있는 인코딩 목록을 확인하는 명령어는 ruby -e 'puts Encoding::list.join("\n")' 이다. | encoding: ENCODING |
| class='name'>Defaults class='description'> 머리말 변수의 디폴트 값을 설정한다. | 아래 내용 참조 |
Site Destination 폴더는 사이트 빌드 시 초기화됩니다
사이트 빌드 시에 자동으로
<destination>안의 파일을 지우는 것이 디폴트로 설정되어 있습니다. 사이트에서 생성하지 않는 파일은 모두 사라질 것입니다. 환경설정 옵션<keep_files>를 사용해 그대로 옮길 파일들을 지정할 수 있습니다.
빌드 명령어 옵션
| 설정 | 옵션과 플래그 |
|---|---|
| Regeneration 파일이 수정되었을 때 사이트를 자동으로 다시 생성한다. | -w, --[no-]watch |
Configuration_config.yml 대신 사용할 환경설정 파일을 직접 선택한다. 여러 파일에 동일한 옵션이 설정되어 있으면, 마지막 설정파일의 내용을 사용한다. | --config FILE1[,FILE2,...] |
| Drafts 초안 기능을 사용한다. | show_drafts: BOOL --drafts |
| Environment 빌드 시 임의의 환경변수 값을 사용한다. | JEKYLL_ENV=production |
| Future 현재시간 이후의 포스트나 컬렉션 문서를 게시한다. | future: BOOL --future |
| Unpublished 미개시로 지정된 포스트를 처리한다. | unpublished: BOOL --unpublished |
| LSI 관련된 포스트들에 대한 인덱스를 생성한다. classifier-reborn 플러그인이 필요하다. | lsi: BOOL --lsi |
| Limit Posts 포스트의 수를 제한한다. | limit_posts: NUM --limit_posts NUM |
| Force polling 감시 기능을 강제로 활성화한다. | force_polling: BOOL --force_polling |
| Verbose output 결과를 자세하게 출력한다. | -V, --verbose |
| Silence Output 사이트 빌드 시 발생하는 일반 메시지를 출력하지 않는다 | -q, --quiet |
| Incremental build 실험 기능인 증분 빌드를 활성화한다. 증분 빌드란 변경된 페이지나 포스트만을 다시 빌드하는 기능으로서, 규모가 큰 사이트에서 눈에 띄는 성능 향상을 가져올 수 있다. 하지만 특정한 상황에서는 사이트 생성에 문제가 생길 수도 있다. | incremental: BOOL -I, --incremental |
| Liquid profiler 병목현상이 발생하는 원인을 찾을 수 있게 도와주는 Liquid 렌더링 프로파일을 생성한다. | profile: BOOL --profile |
| Strict Front Matter 페이지의 머리말에 YAML 문법 에러가 있으면 빌드를 중단한다. | strict_front_matter: BOOL --strict_front_matter |
| Base URL 주어진 URL 로 웹사이트를 작동시킨다. | baseurl: URL --baseurl URL |
미리보기 명령 옵션
serve 명령은 아래 나열된 옵션 뿐만 아니라 build 명령의 옵션도 사용할 수 있습니다. 먼저 build 작업에 해당 옵션이 사용된 후에 serve 작업이 수행됩니다.
| 설정 | 옵션과 플래그 |
|---|---|
| Local Server Port Listen 포트 번호를 설정한다. | port: PORT --port PORT |
| Local Server Hostname Listen 호스트명을 설정한다. | host: HOSTNAME --host HOSTNAME |
| Live Reload 컨텐츠가 수정되었을 때 자동으로 브라우저에서 페이지를 다시 불러온다. | livereload: true -l, --livereload |
| Detach 터미널에서 서버를 분리한다. | detach: BOOL -B, --detach |
| Skips the initial site build 사이트 빌드를 건너뛰고 서버를 실행한다 | --skip-initial-build |
| X.509 (SSL) Private Key 사이트 코드에 포함되어 있거나 심볼릭 링크되어 있는 SSL 개인 키. | --ssl-key |
| X.509 (SSL) Certificate 사이트 코드에 포함되어 있거나 심볼릭 링크되어 있는 SSL 공인 인증서. | --ssl-cert |
환경설정 파일에 탭 문자를 사용하지 마세요
파싱 에러가 발생하거나 기본 설정값이 사용될 것입니다. 대신 띄어쓰기를 사용하세요.